home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / clipmn40.arc / CLIPTEST.MNU < prev    next >
Encoding:
Text File  |  1987-10-29  |  14.6 KB  |  310 lines
  1. Introduction
  2. ═══════════════════════════════════════════════════════════════════════════════
  3. The program will not translate these lines because they do NOT have a
  4. delimiter.  This is useful when you want to internally document a menu
  5. outline.
  6.  
  7. This is the document file for ClipMenu 4.0 by John Kaster
  8.  
  9. Based on Artificial Intelligence techniques - I'm told that I must be
  10. artificially intelligent, and these are my techniques, so . . .
  11. ═══════════════════════════════════════════════════════════════════════════════
  12. The parameters passed are:
  13. ClipMenu <input file name>,<output file name>,<full program>,<delimiter>
  14. If the first or second parameter is not passed, you will be prompted for them
  15. Third parameter:   "Y", "y", "N", "n". Default="Y"
  16. Fourth parameter:  defaults to ASCII character 124 decimal, 7C hex
  17.  
  18. Limits on the parts of the menu outline:
  19. First part - 9 characters  (menu prompt)
  20. Second part - 64 characters (procedure to call, or command)
  21. Third part - 80 characters (message for prompt)
  22.  
  23. Type "ClipMenu README.HLP Demo" for a demonstration of this program, then
  24. look at DEMO.PRG.
  25.  
  26. NEW FEATURES (August 1, 1987):
  27.  
  28. 1)  Faster screen displays by saving screens for the various menu options.  If
  29. you are cramped for memory, simply add "RELEASE <procname>"  (where <procname>
  30. is the name of the procedure [also the SAVED SCREEN] that you are in) to each
  31. procedure right before the "RETU" statement.  You will have slower screens, but
  32. you won't run out of memory.
  33.  
  34. 2)  For any menu option, you can INCLUDE or INSERT a text file for that option
  35. so that if you want to do multiple actions under one menu option without
  36. making it a procedure (as in the case of when you want to create a GLOBAL
  37. array), you don't have to recode the menu system every time you change the
  38. menu.  Just put that text into an ASCII file and tell the program to insert it
  39. at that menu option with the code '■I' (character 254 decimal followed by an
  40. upper or lowercase "I").  See the examples in the menu.
  41.  
  42. NEW FEATURES (August 29, 1987):
  43.  
  44. 3)  If you need to set up reference arrays in your main program so the arrays
  45. be used globally (when, for instance, you're using my InArray() function) you
  46. can put it on a line before the menu starts, as in ■IARRCHECK.PRC.  You can
  47. set up an array to be used globally inside anything called from within a
  48. submenu by including the file anywhere underneath that main menu option.
  49. Pretty slick, huh?
  50.  
  51. 4)  RAM testing to determine if you have enough free RAM to save the sub-menu
  52. screens.
  53.  
  54. NEW FEATURES (August 31, 1987):
  55.  
  56. 5)  A configuration file has been implemented.  Put it in the same path as
  57. ClipMenu and name it CLIPMENU.CMC.  The first line should be your name, the
  58. second line your copyright notice, the third line whether you want ClipMenu to
  59. generate the same screen utilities found in EXTENDB2.PRG.  Be sure to include
  60. a hard return at the end of the third line.
  61.  
  62. NEW FEATURES (October 28, 1987):
  63.  
  64. 6)  An "unlimited" depth of pop-up menus from the pull-down menu (level 1).
  65. The program is not sensitive to screen boundaries, but if you set up your
  66. menu correctly, with "Quit" as the rightmost option, there should be no
  67. problem with invalid screen ranges.  The example menu is not intended to be
  68. an example of good menuing structure - it's very poor.  It's just intended
  69. to demonstrate the power of the menu generator.  I would seriously wonder
  70. about any menu system that had to go that deep for a user to do something.
  71.  
  72.  
  73. Responses
  74. If you like this program and want to use it to help create your applications,
  75. please send $15.00 to:
  76.  
  77. Center on
  78. John Kaster
  79. 6064 Old Landing Way
  80. Burke, VA 22015
  81. 703/250-9884
  82. Center off
  83.  
  84. For a faster response, leave a message for John Kaster on:
  85. Center on
  86. EXEC-PC BBS in Milwaukee, WI  414/964-5160
  87. 1200 - 9600 BAUD
  88.  
  89. - or -
  90.  
  91. The BREEZE in Virginia 703/920-7028
  92. 1200 BAUD
  93. Center off
  94.  
  95. If you do buy this utility, you will be informed of any updates or other
  96. Clipper(tm) utilities I create.
  97.  
  98. Revision History
  99. John Kaster
  100. Original:  September 22, 1986
  101. Revised.:  January 11, 1987
  102. Revised.:  January 24, 1987
  103. Revised.:  March 6, 1987
  104. Revised.:  July 25, 1987
  105. Revised.:  August 1, 1987
  106. Revised.:  August 29, 1987
  107. Revised.:  October 28, 1987
  108.  
  109. GRIPES
  110. All the enhancements to this system I have created out of my own SUPERB
  111. imagination.  The only responses to ClipMenu came from co-workers in my own
  112. office.  I think some people out there must be using this utility, because I
  113. see it on boards that I didn't load it on.  Or else you're all just trying to
  114. get download credit!  Anyway, the reason I released this program into the
  115. public domain was to get some helpful suggestions.  If I don't get any
  116. helpful responses, I'm not going to bother uploading it any more.  How's that
  117. for spiteful!  I'm interested in seeing how I can improve this system with
  118. other programmer's suggestions . . . or don't you guys (and gals) think you
  119. can teach me anything?
  120.  
  121. Example menu - introduction
  122. ──────────────────────────────────────────────────────────────────────────────
  123. Below is a demonstration menu outline for ClipMenu.COM.  All lines with the
  124. delimiter you define that have a leading "." are considered a suboption.  The
  125. depth of the menu option is indicated by the number of periods.  No error or
  126. warning messages occur in this version for improperly nested levels, so pay
  127. attention to what you're doing.
  128.  
  129. For procedures that have a space (refer to GO BOTT under browse), the DO will
  130. be omitted in the menu generation.  If you use "RETU", or "QUIT" (exactly like
  131. that), CLIPMENU will omit the "DO " in front of them.  This test IS case
  132. sensitive.
  133.  
  134. One possible problem occurs when the left and right arrow keys are stuffed for
  135. moving through the submenus.  If you have a menu option that doesn't have
  136. any submenus, it will be automatically executed because of the way the
  137. keys are programmed.
  138.  
  139. Happy Computing!
  140. Menu System Outline - Syntactical examples
  141. ──────────────────────────────────────────────────────────────────────────────
  142.  
  143. Modify|Modify|Change data in the selected data file
  144.  . Browse|■IModify.1|Browse through the data file quickly
  145.  . Delete|* DO CHNGREC WITH 'Delete'|Mark a record for deletion
  146.  . Edit|Update|Add or change a record in the selected data file
  147.  . . First|SELE1|Edit the first file
  148.  . . . Add|Addrec|Add a record to the file 1
  149.  . . . . Name|* Get by Name|Add a record by name
  150.  . . . . Date|* Get by Date|Add a record by date
  151.  . . . . Title|* Get by Title|Add a record by title
  152.  . . . . Quit|RETU|Return to the previous menu
  153.  . . . Delete|* DelRec|Delete a record from the file 1
  154.  . . . Change|* Change|Change a record from file 1
  155.  . . . Quit|RETU|Return to the Editing file 1 menu
  156.  . . Second|SELE2|Edit the second file
  157.  . . . Add|* Addrec|Add a record to the file 2
  158.  . . . Delete|* DelRec|Delete a record from the file 2
  159.  . . . Change|* Change|Change a record from file 2
  160.  . . . Quit|RETU|Return to the Editing file 2 menu
  161.  . . Third|SELE3|Edit the third file
  162.  . . . Add|* Addrec|Add a record to the file 3
  163.  . . . Delete|* DelRec|Delete a record from the file 3
  164.  . . . Change|* Change|Change a record from file 3
  165.  . . . Quit|RETU|Return to the Editing file 3 menu
  166.  . . Quit|RETU|Return to the Modify menu
  167.  . Pack|* PACKEM|Remove all records marked for deletion from the selected data file
  168.  . Restore|* DO CHNGREC WITH 'Restore'|UN-delete a record
  169.  . Status|* STATS|Status report on the system
  170.  . Quit|RETU|Return to the main menu
  171. Report|ReptMenu|Print a report
  172.  . Output|OpChoice|Select direction for output
  173.  . . Disk|* DO SELEFILE WITH '*.TXT'|Send output to a DISK FILE
  174.  . . Printer|OUTPUT = 'P'|Send output to the PRINTER
  175.  . . Screen|OUTPUT = 'S'|Send output to the SCREEN
  176.  . . Quit|RETU|Abort sending output anywhere
  177.  . Graph|* DO Graph|Get my file HPPLOTxx.ARC!
  178.  . Print|* DO Rept|Get my file HPLJLBxx.ARC!
  179.  . Quit|RETU|Return to the main menu
  180. Quit|QuitIt|Quit the ClipMenu 3.5 Demonstration system
  181.  . Yes|keyboard chr(27)+chr(27)|Yes, Quit the ClipMenu 3.5 Demonstration system
  182.  . No|RETU|No, return to the main menu
  183.  . Info|Info|Get information on the windowing functions
  184.  . . First|INFO1|Select the first file
  185.  . . . General|Gen1|Get general information
  186.  . . . . Job|Job11|Get information by Job in level 1
  187.  . . . . . X Prompt|* Last prompt|Last level
  188.  . . . . . Y Prompt|* Last prompt|Last level
  189.  . . . . . Z Prompt|* Last prompt|Last level
  190.  . . . . . Quit|RETU|Return to the previous menu
  191.  . . . . Specific|Spec11|Get specific information
  192.  . . . . . X Prompt|* Last prompt|Last level
  193.  . . . . . Y Prompt|* Last prompt|Last level
  194.  . . . . . Z Prompt|* Last prompt|Last level
  195.  . . . . . Quit|RETU|Return to the previous menu
  196.  . . . . Help|Help11|Get some help (professional, that is)
  197.  . . . . . X Prompt|* Last prompt|Last level
  198.  . . . . . Y Prompt|* Last prompt|Last level
  199.  . . . . . Z Prompt|* Last prompt|Last level
  200.  . . . . . Quit|RETU|Return to the previous menu
  201.  . . . . Quit|RETU|Return to the previous menu
  202.  . . . Name|Name1|Get information by name in level 1
  203.  . . . . Job|* Job12|Get information by Job in level 1
  204.  . . . . Specific|* Spec12|Get specific information
  205.  . . . . Help|* Help12|Get some help (professional, that is)
  206.  . . . . Quit|RETU|Return to the previous menu
  207.  . . . Date|Date1|Get information by Date in level 1
  208.  . . . . Job|* Job13|Get information by Job in level 1
  209.  . . . . Specific|* Spec13|Get specific information
  210.  . . . . Help|* Help13|Get some help (professional, that is)
  211.  . . . . Quit|RETU|Return to the previous menu
  212.  . . . Title|Title1|Get information by Title in level 1
  213.  . . . . Job|Job14|Get information by Job in level 1
  214.  . . . . . X Prompt|* Last prompt|Last level
  215.  . . . . . Y Prompt|* Last prompt|Last level
  216.  . . . . . Z Prompt|* Last prompt|Last level
  217.  . . . . . Quit|RETU|Return to the previous menu
  218.  . . . . Specific|Spec14|Get specific information
  219.  . . . . . X Prompt|* Last prompt|Last level
  220.  . . . . . Y Prompt|* Last prompt|Last level
  221.  . . . . . Z Prompt|* Last prompt|Last level
  222.  . . . . . Quit|RETU|Return to the previous menu
  223.  . . . . Help|Help14|Get some help (professional, that is)
  224.  . . . . . X Prompt|* Last prompt|Last level
  225.  . . . . . Y Prompt|* Last prompt|Last level
  226.  . . . . . Z Prompt|* Last prompt|Last level
  227.  . . . . . Quit|RETU|Return to the previous menu
  228.  . . . . Quit|RETU|Return to the previous menu
  229.  . . . Position|Position1|Get information by Position in level 1
  230.  . . . . Job|* Job15|Get information by Job in level 1
  231.  . . . . Specific|* Spec15|Get specific information
  232.  . . . . Help|* Help15|Get some help (professional, that is)
  233.  . . . . Quit|RETU|Return to the previous menu
  234.  . . . Salary|Salary1|Get information by Salary in level 1
  235.  . . . . Job|* Job16|Get information by Job in level 1
  236.  . . . . Specific|* Spec16|Get specific information
  237.  . . . . Help|* Help16|Get some help (professional, that is)
  238.  . . . . Quit|RETU|Return to the previous menu
  239.  . . . Quit|RETU|Return to the previous menu
  240.  . . Second|INFO2|Select the second file
  241.  . . . General|Gen2|Get general information
  242.  . . . . Job|* Job21|Get information by Job in level 2
  243.  . . . . Specific|* Spec21|Get specific information
  244.  . . . . Help|* Help21|Get some help (professional, that is)
  245.  . . . . Quit|RETU|Return to the previous menu
  246.  . . . Name|Name2|Get information by name in level 2
  247.  . . . . Job|* Job22|Get information by Job in level 2
  248.  . . . . Specific|* Spec22|Get specific information
  249.  . . . . Help|* Help22|Get some help (professional, that is)
  250.  . . . . Quit|RETU|Return to the previous menu
  251.  . . . Date|Date2|Get information by Date in level 2
  252.  . . . . Job|* Job23|Get information by Job in level 2
  253.  . . . . Specific|* Spec23|Get specific information
  254.  . . . . Help|* Help23|Get some help (professional, that is)
  255.  . . . . Quit|RETU|Return to the previous menu
  256.  . . . Title|Title2|Get information by Title in level 2
  257.  . . . . Job|* Job24|Get information by Job in level 2
  258.  . . . . Specific|* Spec24|Get specific information
  259.  . . . . Help|* Help24|Get some help (professional, that is)
  260.  . . . . Quit|RETU|Return to the previous menu
  261.  . . . Position|Position2|Get information by Position in level 2
  262.  . . . . Job|* Job25|Get information by Job in level 2
  263.  . . . . Specific|* Spec25|Get specific information
  264.  . . . . Help|* Help25|Get some help (professional, that is)
  265.  . . . . Quit|RETU|Return to the previous menu
  266.  . . . Salary|Salary2|Get information by Salary in level 2
  267.  . . . . Job|* Job26|Get information by Job in level 2
  268.  . . . . Specific|* Spec26|Get specific information
  269.  . . . . Help|* Help26|Get some help (professional, that is)
  270.  . . . . Quit|RETU|Return to the previous menu
  271.  . . . Quit|RETU|Return to the previous menu
  272.  . . Third|INFO3|Select the third file
  273.  . . . General|Gen3|Get general information
  274.  . . . . Job|* Job31|Get information by Job in level 3
  275.  . . . . Specific|* Spec31|Get specific information
  276.  . . . . Help|* Help31|Get some help (professional, that is)
  277.  . . . . Quit|RETU|Return to the previous menu
  278.  . . . Name|Name3|Get information by name in level 3
  279.  . . . . Job|* Job32|Get information by Job in level 3
  280.  . . . . Specific|* Spec32|Get specific information
  281.  . . . . Help|* Help32|Get some help (professional, that is)
  282.  . . . . Quit|RETU|Return to the previous menu
  283.  . . . Date|Date3|Get information by Date in level 3
  284.  . . . . Job|* Job33|Get information by Job in level 3
  285.  . . . . Specific|* Spec33|Get specific information
  286.  . . . . Help|* Help33|Get some help (professional, that is)
  287.  . . . . Quit|RETU|Return to the previous menu
  288.  . . . Title|Title3|Get information by Title in level 3
  289.  . . . . Job|* Job34|Get information by Job in level 3
  290.  . . . . Specific|* Spec34|Get specific information
  291.  . . . . Help|* Help34|Get some help (professional, that is)
  292.  . . . . Quit|RETU|Return to the previous menu
  293.  . . . Position|Position3|Get information by Position in level 3
  294.  . . . . Job|* Job35|Get information by Job in level 3
  295.  . . . . Specific|* Spec35|Get specific information
  296.  . . . . Help|* Help35|Get some help (professional, that is)
  297.  . . . . Quit|RETU|Return to the previous menu
  298.  . . . Salary|Salary3|Get information by Salary in level 3
  299.  . . . . Job|* Job36|Get information by Job in level 3
  300.  . . . . Specific|* Spec36|Get specific information
  301.  . . . . Help|* Help36|Get some help (professional, that is)
  302.  . . . . Quit|RETU|Return to the previous menu
  303.  . . . Quit|RETU|Return to the previous menu
  304.  . . Quit|RETU|Return to the Info menu
  305.  
  306. ──────────────────────────────────────────────────────────────────────────────
  307. Please note - you MUST have at least one extra line at the end of the menu
  308. outline file.  Otherwise, your last option will not be translated.
  309. ──────────────────────────────────────────────────────────────────────────────
  310.